home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / abe.arc / ABE_DOC.ABE next >
Text File  |  1989-06-22  |  49KB  |  729 lines
  1. ;ABE ASCII-Binary-Encoding (by Brad Templeton)
  2. ;Use 'sort' and/or 'dabe' to decode
  3. T.//$$filecount=3
  4. T.0N##S1000,1000,1000,ABE1
  5. T.1N$$blocking=false
  6. T.2h$$uname=abe.man
  7. T.3a$$os=gemdos
  8. T.4r$$fname=abe_doc\abe.man
  9. T.5z$$date=614524958
  10. T.6d$$perm=0
  11. T.79$$size=15588
  12. T.8b""%KFDCMBA@>M=</:J9\87D6543M2GE1M0/.-M,+)(M
  13. T.9i""&.J*'&%%&'C()*+(,-&;%0123%4567%89:;&<=>?&
  14. T.Ak""'@ABC%DEFG%HIJK(LMNO%PQRS.TUVW%XYZ[(\]^_C
  15. T.BZ""(`abc%defg%hijk%lmno%pqrs%tuvw%xyz^%?ZQI&
  16. T.Cj"")HLMNMOPRSMTUVWMXY[]M_`abMcdefMghijMklmnM
  17. T.Dq""*opqrMstuvMwxyzM%&'(u)*+,u-./0u1234u5678u
  18. T.Eb""+9:;<u=>?@uABCDuEFGHuIJKLuMNOPuQRSTuUVWXu
  19. T.Fc"",YZ[\u]^_`uabcduefghuijklumnopuqrstuuvwxu
  20. T.Gx\/\/\/.....ABE(1)........................UNIX....................
  21. T.HW.....ABE(1)\/\/\/\/.....NAME\/..........abe.-.Ascii-Binary.Encode
  22. T.ICr\/\/.....SYNOPSIS\/..........abe.[.options.].[filename.&&&]\/\/.
  23. T.Jy....DESCRIPTION\/..........The._abe.program.program.encodes.binar
  24. T.Kny.files.into.a.bullet-\/..........proof.form.consisting.only.of.p
  25. T.L2rintable.ASCII.characters&\/..........This.new.form.can.be.sent.t
  26. T.Mfhrough.communications.channels\/..........which.might.get.upset.a
  27. T.Ntt.non-printable.characters,.such.as\/..........USENET.news,.mail.
  28. T.Owand.various.text.file.downloading\/..........programs&..ABE.files
  29. T.PY.should.be.able.to.pass.through.a.lot.of\/..........mechanisms.an
  30. T.Qyd.Operating.Systems.that.will.kill.lesser\/..........files&\/\/..
  31. T.Rk........_Abe.is.a.replacement.for.the._uuencode(1).program&...The
  32. T.SB\/..........encodings.produced.by.abe.are.usually.smaller,.more\/
  33. T.TH..........compressible,.more.readable.and.far.more.bullet-proof.t
  34. T.UOhan\/..........those.produced.by._uuencode&\/\/..........All.line
  35. T.Vas.in.an.ABE.encoding.have.a.three.character.line\/..........numbe
  36. T.W9r.as.well.as.a.checksum&..That.means.that.ABE.lines.may\/........
  37. T.XC..be.broken.apart,.scrambled.in.a.random.order,.and.even.have\/..
  38. T.Yf........garbage.lines.inserted.into.them.without.damage&..The\/..
  39. T.ZE........_sort(1).program.(or.any.other.text.file.sort.utility).ca
  40. T.aLn\/..........always.restore.an.ABE.file.to.its.proper.state&\/\/.
  41. T.b2.........ABE.files.can.be.split.into.*blocks*.when.the.transport\
  42. T.cN/..........mechanism.being.used.is.unable.to.transfer.files.longe
  43. T.djr.than\/..........a.given.length&..These.blocks.contain.checksums
  44. T.e0,.length\/..........information.and.`seek.address'.information.fo
  45. T.fLr.independent\/..........verification&..With.the.full._dabe.ABE.d
  46. T.gWecoder,.it.is\/..........possible.to.still.decode.a.file.with.mis
  47. T.hZsing.blocks&..Empty\/..........regions.will.simply.be.left.undefi
  48. T.iOned.in.the.resulting.file&\/..........If.redundant.decoding.infor
  49. T.j8mation.is.added.to.the.blocks,\/..........they.can.be.presented.t
  50. T.kso.the.decoder.in.any.order,.without\/..........sorting,.and.block
  51. T.lms.may.even.be.duplicated&..All.this.was\/..........designed.with.
  52. T.mNthe.typical.problems.of.USENET.binary\/..........distribution.in.
  53. T.nKmind&\/\/..........Two.decoders.exist&..One.is.the.`tiny'.decoder
  54. T.on,._tinydabe&c&\/..........This.is.a.100.line,.public.domain,.port
  55. T.p1able.C.program.which\/..........can.be.included.with.ABE.files&..
  56. T.qRThus.any.person.with.a.C\/..........compiler.can.decode.an.ABE.fi
  57. T.rule,.even.if.they.have.never\/..........heard.of.ABE.files.before&
  58. T.s6..It.is.limited.to.single.file\/..........encodings.of.less.than.
  59. T.tC2.megabytes.in.size&\/\/..........The.full.ABE.decoder,._dabe,.mo
  60. T.uyre.advanced.decoding,.with\/..........more.error.checking,.is.pos
  61. T.vFsible&..It.is.suggested.that.the\/..........tiny.decoder.only.be.
  62. T.wbused.by.first.time.users.of.the.format,\/..........and.those.who.
  63. T.xGplan.more.work.should.endeavour.to.use.the\/\/\/\/.....Page.1....
  64. T.yz......................................(printed.6;11;89)\/\/\/\/\/
  65. T.zC\/\/.....ABE(1)........................UNIX......................
  66. T/.A...ABE(1)\/\/\/\/..........complete.decoder&\/\/.....OPTIONS\/...
  67. T//0.......(Note.that.while.option.names.are.displayed.here.in.full,\
  68. T/0P/..........only.the.first.letter.is.actually.required&..For.+;-\/
  69. T/10..........options,.using.+.turns.the.option.on,.and.using.-.turns
  70. T/25.the\/..........option.off&)\/\/..........blocksize=num\/........
  71. T/3y.......Request.that.files.be.split.into.blocks.with.an\/.........
  72. T/4f......approximate.size.of._num&.Note.that.files.will.actually\/..
  73. T/5s.............be.a.little.bit.larger.than.the.requested.size,.so\/
  74. T/6y...............choose.a.number.lower.than.your.hard.maximum&..Blo
  75. T/7vcks\/...............will.be.put.into.the.single.output.file.unles
  76. T/8Ns.an\/...............output.file.prefix.name.is.provided.(p=name)
  77. T/9r&\/\/..........prefix=str\/...............Normally,._abe.writes.e
  78. T/Agncodings.to.the.standard.output&\/...............This.option.turn
  79. T/Bjs.on.file.blocking,.and.arranges.for\/...............each.block.t
  80. T/Cfo.go.into.a.different.file&..All.file.names\/...............will.
  81. T/DEstart.with.the.prefix._str.and.will.have.a.2-digit\/.............
  82. T/E2..hexadecimal.number.at.the.end&..The.default.block.size\/.......
  83. T/FO........is.40,000.characters,.but.that.may.be.set.with.the\/.....
  84. T/Gh..........(b=num).option&\/\/..........prefix=?command\/.........
  85. T/HU......On.UNIX.systems,.if.the.prefix.string.begins.with.an\/.....
  86. T/Iu..........or-bar.(?),.the.blocks.will.actually.be.piped.through.a
  87. T/JU\/...............shell.process.using.popen(3)&..The.shell.command
  88. T/K1.string\/...............passed.to.popen.will.be.that.generated.by
  89. T/Ld.sprintf(3)\/...............with.the.prefix.string.(excluding.the
  90. T/Mb.or-bar).given.as\/...............the.format.string,.and.the.file
  91. T/NL.number.given.as.an\/...............integer.argument&..For.exampl
  92. T/O2e,.on.Unix:\/...................abe.b=25000.file.*p=?mail.-s.'Par
  93. T/PNt%d'.fbaggins*\/...............would.mail.all.the.blocks,.with.ti
  94. T/Qptles,.to.user\/...............fbaggins&..Note.that.you.must.quote
  95. T/R9.the.whole.option,\/...............or.the.or-bar.will.be.taken.as
  96. T/Sz.a.pipe.character.by.the\/...............Unix.shell&\/\/.........
  97. T/Tk.universalnname=name\/...............ABE.encodings.include.both.t
  98. T/UBhe.real.name.of.the.encoded\/...............file.and.a.special.un
  99. T/VYiversal.name.that.is.limited.to.12\/...............characters.and
  100. T/Wq.should.contain.no.directory.characters\/...............like.slas
  101. T/Xyh&..The.universal.name.is.used.when.decoding\/...............on.a
  102. T/Y4n.operating.system.different.from.the.encoder's\/...............s
  103. T/Zyystem&..Universal.names.are.also.used.when.multiple\/............
  104. T/aM...files.are.placed.in.the.same.encoding&..If.you.don't\/........
  105. T/bc.......provide.a.universal.name,.one.will.be.formed.from.the\/...
  106. T/cD............real.file.name&..You.can.only.provide.your.own\/.....
  107. T/db..........universal.name.when.encoding.a.single.file&..If.no\/...
  108. T/er............filename.is.given,.a.universal.name.of.*stdin*.is.use
  109. T/fEd&\/\/\/\/\/.....Page.2..........................................
  110. T/gH(printed.6;11;89)\/\/\/\/\/\/\/.....ABE(1).......................
  111. T/h8.UNIX.........................ABE(1)\/\/\/\/..........decoder=pat
  112. T/ihhname\/...............Insert.the.source.to.the.tiny.ABE.decoder.*
  113. T/jVtinydabe&c*\/...............from.the.file.in._pathname&\/\/......
  114. T/kN....sample=size\/..............._abe.and.do.either.a.single.pass.
  115. T/lvor.double.pass.over.its\/...............input,.except.when.the.in
  116. T/mOput.is.the.standard.input,.in\/...............which.case.only.a.s
  117. T/nringle.pass.is.possible&.._abe.likes\/...............to.do.two.pas
  118. T/ozses.so.that.it.can.get.frequency.tables\/...............for.the.b
  119. T/pXytes.in.the.input.file&..The.more.accurate.the\/...............fr
  120. T/q6equency.tables,.the.smaller.the.encoding&..If.two\/..............
  121. T/rF.passes.are.not.possible,.or.you.request.one-pass\/..............
  122. T/sQ.operation.with.this.option,._abe.reads.in.a.buffer.of\/.........
  123. T/ta......size._size.and.builds.the.frequency.table.from.that&\/.....
  124. T/uY..........The.default.(for.stdin).is.10,000.bytes&..You.can.set\/
  125. T/vu...............it.as.high.as.the.limit.for.dynamic.memory.allocat